home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmCascadeButtonGadget.z / XmCascadeButtonGadget
Encoding:
Text File  |  2003-11-18  |  22.1 KB  |  463 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_C_a_s_c_a_d_e_B_u_t_t_o_n_G_a_d_g_e_t    - The CascadeButtonGadget widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       #include <Xm/CascadeBG.h>
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       CascadeButtonGadget links two    MenuPanes, a MenuBar to    a
  16.       MenuPane, or an OptionMenu to    a MenuPane.
  17.  
  18.       It is    used in    menu systems and must have a RowColumn parent
  19.       with its _X_m_N_r_o_w_C_o_l_u_m_n_T_y_p_e resource set to _X_m_M_E_N_U__B_A_R,
  20.       _X_m_M_E_N_U__P_O_P_U_P,    _X_m_M_E_N_U__P_U_L_L_D_O_W_N, or _X_m_M_E_N_U__O_P_T_I_O_N.
  21.  
  22.       It is    the only gadget    that can have a    Pulldown MenuPane
  23.       attached to it as a submenu.    The submenu is displayed when
  24.       this gadget is activated within a PopupMenu, a PulldownMenu,
  25.       or an    OptionMenu.  Its visuals can include a label or    pixmap
  26.       and a    cascading indicator when it is in a Popup or Pulldown
  27.       MenuPane; or it can include only a label or a    pixmap when it
  28.       is in    an OptionMenu.
  29.  
  30.       The default behavior associated with a CascadeButtonGadget
  31.       depends on the type of menu system in    which it resides.  By
  32.       default, _B_S_e_l_e_c_t controls the    behavior of the
  33.       CascadeButtonGadget.    In addition, _B_M_e_n_u controls the
  34.       behavior of the CascadeButtonGadget if it resides in a Menu
  35.       system.  The actual mouse button used    is determined by its
  36.       RowColumn parent.
  37.  
  38.       A CascadeButtonGadget's visuals differ from most other
  39.       button gadgets.  When    the button becomes armed, its visuals
  40.       change from a    2-D to a 3-D look, and it displays the submenu
  41.       that has been    attached to it.     If no submenu is attached, it
  42.       simply changes its visuals.
  43.  
  44.       When a CascadeButtonGadget within a Pulldown or Popup
  45.       MenuPane is armed as the result of the user moving the mouse
  46.       pointer into the gadget, it does not immediately display its
  47.       submenu.  Instead, it    waits a    short time to see if the
  48.       arming was temporary (that is, the user was simply passing
  49.       through the gadget), or the user really wanted the submenu
  50.       posted.  This    delay is configurable via _X_m_N_m_a_p_p_i_n_g_D_e_l_a_y.
  51.  
  52.       CascadeButtonGadget provides a single    mechanism for
  53.       activating the gadget    from the keyboard.  This mechanism is
  54.       referred to as a keyboard mnemonic.  If a mnemonic has been
  55.       specified for    the gadget, the    user may activate it by    simply
  56.       typing the mnemonic while the    CascadeButtonGadget is
  57.       visible.  If the CascadeButtonGadget is in a MenuBar and the
  58.       MenuBar does not have    the focus, the _M_A_l_t modifier must be
  59.       pressed with the mnemonic.  Mnemonics    are typically used to
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  71.  
  72.  
  73.  
  74.       interact with    a menu via the keyboard.
  75.  
  76.       If a CascadeButtonGadget is in a Pulldown or Popup MenuPane
  77.       and there is a submenu attached, the _X_m_N_m_a_r_g_i_n_B_o_t_t_o_m,
  78.       _X_m_N_m_a_r_g_i_n_L_e_f_t, _X_m_N_m_a_r_g_i_n_R_i_g_h_t, and _X_m_N_m_a_r_g_i_n_T_o_p resources
  79.       may enlarge to accommodate _X_m_N_c_a_s_c_a_d_e_P_i_x_m_a_p.    _X_m_N_m_a_r_g_i_n_W_i_d_t_h
  80.       defaults to 6    if this    resource is in a MenuBar; otherwise,
  81.       it takes LabelGadget's default, which    is 2.
  82.  
  83.     CCCCllllaaaasssssssseeeessss
  84.       CascadeButtonGadget inherits behavior    and resources from
  85.       _O_b_j_e_c_t, _R_e_c_t_O_b_j, _X_m_G_a_d_g_e_t, and _X_m_L_a_b_e_l_G_a_d_g_e_t classes.
  86.  
  87.       The class pointer is _x_m_C_a_s_c_a_d_e_B_u_t_t_o_n_G_a_d_g_e_t_C_l_a_s_s.
  88.  
  89.       The class name is _X_m_C_a_s_c_a_d_e_B_u_t_t_o_n_G_a_d_g_e_t.
  90.  
  91.     NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  92.       The following    table defines a    set of widget resources    used
  93.       by the programmer to specify data.  The programmer can also
  94.       set the resource values for the inherited classes to set
  95.       attributes for this widget.  To reference a resource by name
  96.       or by    class in a .Xdefaults file, remove the _X_m_N or _X_m_C
  97.       prefix and use the remaining letters.     To specify one    of the
  98.       defined values for a resource    in a .Xdefaults    file, remove
  99.       the _X_m prefix    and use    the remaining letters (in either
  100.       lowercase or uppercase, but include any underscores between
  101.       words).  The codes in    the access column indicate if the
  102.       given    resource can be    set at creation    time (C), set by using
  103.       _X_t_S_e_t_V_a_l_u_e_s (S), retrieved by    using _X_t_G_e_t_V_a_l_u_e_s (G), or is
  104.       not applicable (N/A).
  105.  
  106.                    XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt
  107.      NNNNaaaammmmeeee            CCCCllllaaaassssssss          TTTTyyyyppppeeee           DDDDeeeeffffaaaauuuulllltttt     AAAAcccccccceeeessssssss
  108.      __________________________________________________________________________
  109.      XmNactivateCallback    XmCCallback          XtCallbackList   NULL     C
  110.      XmNcascadePixmap        XmCPixmap          Pixmap           dynamic     CSG
  111.      XmNcascadingCallback   XmCCallback          XtCallbackList   NULL     C
  112.      XmNmappingDelay        XmCMappingDelay   int           180 ms     CSG
  113.      XmNsubMenuId        XmCMenuWidget     Widget           NULL     CSG
  114.  
  115.  
  116.       _X_m_N_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k
  117.            Specifies the list of callbacks that is called when the
  118.            user activates the CascadeButtonGadget, and there is no
  119.            submenu attached    to pop up.  The    activation occurs by
  120.            releasing a mouse button    or by typing the mnemonic
  121.            associated with the gadget.  The    specific mouse button
  122.            depends on information in the RowColumn parent.    The
  123.            reason sent by the callback is _X_m_C_R__A_C_T_I_V_A_T_E.
  124.  
  125.       _X_m_N_c_a_s_c_a_d_e_P_i_x_m_a_p
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  137.  
  138.  
  139.  
  140.            Specifies the cascade pixmap displayed on one end of
  141.            the gadget when a CascadeButtonGadget is    used within a
  142.            Popup or    Pulldown MenuPane and a    submenu    is attached.
  143.            The LabelGadget class resources _X_m_N_m_a_r_g_i_n_B_o_t_t_o_m,
  144.            _X_m_N_m_a_r_g_i_n_L_e_f_t, _X_m_N_m_a_r_g_i_n_R_i_g_h_t, and _X_m_N_m_a_r_g_i_n_T_o_p may be
  145.            modified    to ensure that room is left for    the cascade
  146.            pixmap.    The default cascade pixmap in menus other than
  147.            option menus is an arrow    pointing to the    side of    the
  148.            menu where the submenu will appear.  The    default    for
  149.            the CascadeButtonGadget in an option menu is
  150.            _X_m_U_N_S_P_E_C_I_F_I_E_D__P_I_X_M_A_P.
  151.  
  152.       _X_m_N_c_a_s_c_a_d_i_n_g_C_a_l_l_b_a_c_k
  153.            Specifies the list of callbacks that is called just
  154.            prior to    the mapping of the submenu associated with the
  155.            CascadeButtonGadget.  The reason    sent by    the callback
  156.            is _X_m_C_R__C_A_S_C_A_D_I_N_G.
  157.  
  158.       _X_m_N_m_a_p_p_i_n_g_D_e_l_a_y
  159.            Specifies the amount of time, in    milliseconds, between
  160.            when a CascadeButtonGadget becomes armed    and when it
  161.            maps its    submenu.  This delay is    used only when the
  162.            gadget is within    a Popup    or Pulldown MenuPane.  The
  163.            value must not be negative.
  164.  
  165.       _X_m_N_s_u_b_M_e_n_u_I_d
  166.            Specifies the widget ID for the Pulldown    MenuPane to be
  167.            associated with this CascadeButtonGadget.  The
  168.            specified MenuPane is displayed when the
  169.            CascadeButtonGadget becomes armed.  The MenuPane    must
  170.            have been created with the appropriate parentage
  171.            depending on the    type of    menu used.  See
  172.            _X_m_C_r_e_a_t_e_P_u_l_l_d_o_w_n_M_e_n_u(_3_X), _X_m_C_r_e_a_t_e_P_o_p_u_p_M_e_n_u(_3_X),    and
  173.            _X_m_C_r_e_a_t_e_O_p_t_i_o_n_M_e_n_u(_3_X) for more information on the menu
  174.            systems.
  175.  
  176.     IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  177.       CascadeButtonGadget inherits behavior    and resources from the
  178.       following superclasses.  For a complete description of each
  179.       resource, refer to the man page for that superclass.
  180.  
  181.                         XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  182.      NNNNaaaammmmeeee             CCCCllllaaaassssssss                 TTTTyyyyppppeeee         DDDDeeeeffffaaaauuuulllltttt        AAAAcccccccceeeessssssss
  183.      _________________________________________________________________________________________________________
  184.      XmNaccelerator         XmCAccelerator             String         NULL            N/A
  185.      XmNacceleratorText         XmCAcceleratorText         XmString         NULL            N/A
  186.      XmNalignment         XmCAlignment             unsigned char     dynamic        CSG
  187.      XmNfontList         XmCFontList             XmFontList         dynamic        CSG
  188.      XmNlabelInsensitivePixmap     XmCLabelInsensitivePixmap   Pixmap         XmUNSPECIFIED_PIXMAP    CSG
  189.      XmNlabelPixmap         XmCLabelPixmap             Pixmap         XmUNSPECIFIED_PIXMAP    CSG
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 11/11/03)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  203.  
  204.  
  205.  
  206.      XmNlabelString         XmCXmString             XmString         dynamic        CSG
  207.      XmNlabelType         XmCLabelType             unsigned char     XmSTRING        CSG
  208.      XmNmarginBottom         XmCMarginBottom         Dimension         dynamic        CSG
  209.      XmNmarginHeight         XmCMarginHeight         Dimension         2            CSG
  210.      XmNmarginLeft         XmCMarginLeft             Dimension         0            CSG
  211.      XmNmarginRight         XmCMarginRight             Dimension         dynamic        CSG
  212.      XmNmarginTop         XmCMarginTop             Dimension         dynamic        CSG
  213.      XmNmarginWidth         XmCMarginWidth             Dimension         dynamic        CSG
  214.      XmNmnemonic         XmCMnemonic             KeySym         NULL            CSG
  215.      XmNmnemonicCharSet         XmCMnemonicCharSet         String         dynamic        CSG
  216.      XmNrecomputeSize         XmCRecomputeSize         Boolean         True            CSG
  217.      XmNstringDirection         XmCStringDirection         XmStringDirection     dynamic        CSG
  218.  
  219.  
  220.                     XXXXmmmmGGGGaaaaddddggggeeeetttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  221.      NNNNaaaammmmeeee             CCCCllllaaaassssssss             TTTTyyyyppppeeee        DDDDeeeeffffaaaauuuulllltttt      AAAAcccccccceeeessssssss
  222.      ___________________________________________________________________________________
  223.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel        dynamic      G
  224.      XmNhelpCallback         XmCCallback         XtCallbackList    NULL      C
  225.      XmNhighlightColor         XmCHighlightColor         Pixel        dynamic      G
  226.      XmNhighlightOnEnter     XmCHighlightOnEnter     Boolean        False      CSG
  227.      XmNhighlightThickness   XmCHighlightThickness   Dimension        0      CSG
  228.      XmNnavigationType         XmCNavigationType         XmNavigationType    XmNONE      CSG
  229.      XmNshadowThickness         XmCShadowThickness         Dimension        2      CSG
  230.      XmNtopShadowColor         XmCTopShadowColor         Pixel        dynamic      G
  231.      XmNtraversalOn         XmCTraversalOn         Boolean        True      CSG
  232.      XmNunitType         XmCUnitType         unsigned char    dynamic      CSG
  233.      XmNuserData         XmCUserData         XtPointer        NULL      CSG
  234.  
  235.  
  236.                  RRRReeeeccccttttOOOObbbbjjjj RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  237.      NNNNaaaammmmeeee            CCCCllllaaaassssssss         TTTTyyyyppppeeee     DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  238.      ____________________________________________________________________
  239.      XmNancestorSensitive   XmCSensitive     Boolean     dynamic   G
  240.      XmNborderWidth        XmCBorderWidth   Dimension     0       CSG
  241.      XmNheight            XmCHeight         Dimension     dynamic   CSG
  242.      XmNsensitive        XmCSensitive     Boolean     True       CSG
  243.      XmNwidth            XmCWidth         Dimension     dynamic   CSG
  244.      XmNx            XmCPosition         Position     0       CSG
  245.      XmNy            XmCPosition         Position     0       CSG
  246.  
  247.  
  248.                  OOOObbbbjjjjeeeecccctttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  249.      NNNNaaaammmmeeee          CCCCllllaaaassssssss        TTTTyyyyppppeeee         DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  250.      ____________________________________________________________________
  251.      XmNdestroyCallback      XmCCallback    XtCallbackList     NULL       C
  252.  
  253.  
  254.     CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  255.       A pointer to the following structure is passed to each
  256.       callback:
  257.       typedef struct
  258.  
  259.  
  260.  
  261.      Page 4                        (printed 11/11/03)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  269.  
  270.  
  271.  
  272.       {
  273.         int         rrrreeeeaaaassssoooonnnn;
  274.         _X_E_v_e_n_t   **** eeeevvvveeeennnntttt;
  275.       } _X_m_A_n_y_C_a_l_l_b_a_c_k_S_t_r_u_c_t;
  276.  
  277.       rrrreeeeaaaassssoooonnnn
  278.            Indicates why the callback was invoked.
  279.  
  280.       eeeevvvveeeennnntttt
  281.            Points to the _X_E_v_e_n_t that triggered the callback    or is
  282.            NULL if this callback was not triggered by an _X_E_v_e_n_t.
  283.  
  284.     BBBBeeeehhhhaaaavvvviiiioooorrrr
  285.       XmCascadeButtonGadget    includes behavior from XmGadget.
  286.       XmCascadeButton includes the menu traversal behavior from
  287.       XmLabel.  Additional XmCascadeButtonGadget behavior is
  288.       described below.  In a menu system, _B_M_e_n_u also performs the
  289.       _B_S_e_l_e_c_t actions.
  290.  
  291.       _B_S_e_l_e_c_t _P_r_e_s_s:
  292.            Unposts any menus posted    by the parent menu.  Arms the
  293.            CascadeButtonGadget, posts the associated submenu,
  294.            enables mouse traversal,    and, in    a MenuBar, arms    the
  295.            MenuBar.     If the    menu is    already    active,    this event
  296.            disables    keyboard traversal for the menu    and returns
  297.            the menu    to mouse traversal mode.
  298.  
  299.       _B_S_e_l_e_c_t _R_e_l_e_a_s_e:
  300.            Calls the callbacks in _X_m_N_c_a_s_c_a_d_i_n_g_C_a_l_l_b_a_c_k, posts the
  301.            submenu attached    to the CascadeButtonGadget and enables
  302.            keyboard    traversal within the menu.  If the
  303.            CascadeButtonGadget does    not have a submenu attached,
  304.            calls the callbacks in _X_m_N_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k, the
  305.            CascadeButtonGadget is activated    and all    posted menus
  306.            in the cascade are unposted.
  307.  
  308.       _K_A_c_t_i_v_a_t_e:
  309.            Calls the callbacks in _X_m_N_c_a_s_c_a_d_i_n_g_C_a_l_l_b_a_c_k, and    posts
  310.            the submenu attached to the CascadeButtonGadget if
  311.            keyboard    traversal is enabled in    the menu.  If the
  312.            CascadeButtonGadget does    not have a submenu attached,
  313.            calls the callbacks in _X_m_N_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k, the
  314.            CascadeButtonGadget is activated    and all    posted menus
  315.            in the cascade are unposted.  This action applies only
  316.            to gadgets in MenuBars, PulldownMenus, and PopupMenus.
  317.            For a CascadeButtonGadget in an OptionMenu, if the
  318.            parent is a manager, this action    passes the event to
  319.            the parent.
  320.  
  321.       _K_S_e_l_e_c_t:
  322.            Calls the callbacks in _X_m_N_c_a_s_c_a_d_i_n_g_C_a_l_l_b_a_c_k, and    posts
  323.            the submenu attached to the CascadeButtonGadget if
  324.  
  325.  
  326.  
  327.      Page 5                        (printed 11/11/03)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  335.  
  336.  
  337.  
  338.            keyboard    traversal is enabled in    the menu.  If the
  339.            CascadeButtonGadget does    not have a submenu attached,
  340.            calls the callbacks in _X_m_N_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k, the
  341.            CascadeButtonGadget is activated    and all    posted menus
  342.            in the cascade are unposted.
  343.  
  344.       _K_H_e_l_p:
  345.            Unposts all menus in the    menu hierarchy and, when the
  346.            shell's keyboard    focus policy is    _X_m_E_X_P_L_I_C_T, restores
  347.            keyboard    focus to the widget that had the focus before
  348.            the menu    system was entered.  Calls the callbacks for
  349.            _X_m_N_h_e_l_p_C_a_l_l_b_a_c_k if any exist.  If there are no help
  350.            callbacks for this widget, this action calls the    help
  351.            callbacks for the nearest ancestor that has them.
  352.  
  353.       _M_A_n_y _K_C_a_n_c_e_l:
  354.            In a MenuBar, disarms the CascadeButtonGadget and the
  355.            menu and, when the shell's keyboard focus policy    is
  356.            _X_m_E_X_P_L_I_C_T, restores keyboard focus to the widget    that
  357.            had the focus before the    menu was entered.  For a
  358.            CascadeButtonGadget in an OptionMenu, if    the parent is
  359.            a manager, this action passes the event to the parent.
  360.  
  361.       In a toplevel    Pulldown MenuPane from a MenuBar, unposts the
  362.       menu,    disarms    the MenuBar CascadeButton and the MenuBar,
  363.       and, when the    shell's    keyboard focus policy is _X_m_E_X_P_L_I_C_T,
  364.       restores keyboard focus to the widget    that had the focus
  365.       before the MenuBar was entered.  In other Pulldown
  366.       MenuPanes, unposts the menu.
  367.  
  368.       In a Popup MenuPane, unposts the menu    and restores keyboard
  369.       focus    to the widget from which the menu was posted.
  370.  
  371.       <_E_n_t_e_r>:
  372.            If keyboard traversal is    enabled    does nothing.
  373.            Otherwise, in a MenuBar,    unposts    any MenuPanes
  374.            associated with another MenuBar entry, arms the
  375.            CascadeButtonGadget, and    posts the associated submenu.
  376.            In other    menus, arms the    CascadeButtonGadget and    posts
  377.            the associated submenu after the    delay specified    by
  378.            _X_m_N_m_a_p_p_i_n_g_D_e_l_a_y.
  379.  
  380.       <_L_e_a_v_e>:
  381.            If keyboard traversal is    enabled    does nothing.
  382.            Otherwise, in a MenuBar,    disarms    the
  383.            CascadeButtonGadget if the submenu associated with the
  384.            CascadeButtonGadget is not currently posted or if there
  385.            is no submenu associated    with the CascadeButtonGadget.
  386.  
  387.       In other menus, if the pointer moves anywhere    except into a
  388.       submenu associated with the CascadeButtonGadget, the
  389.       CascadeButtonGadget is disarmed and its submenu is unposted.
  390.  
  391.  
  392.  
  393.      Page 6                        (printed 11/11/03)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX))))
  401.  
  402.  
  403.  
  404.     VVVViiiirrrrttttuuuuaaaallll    BBBBiiiinnnnddddiiiinnnnggggssss
  405.       The bindings for virtual keys    are vendor specific.  For
  406.       information about bindings for virtual buttons and keys, see
  407.       _V_i_r_t_u_a_l_B_i_n_d_i_n_g_s(_3_X).
  408.  
  409.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  410.       _O_b_j_e_c_t(_3_X), _R_e_c_t_O_b_j(_3_X), _X_m_C_a_s_c_a_d_e_B_u_t_t_o_n_H_i_g_h_l_i_g_h_t(_3),
  411.       _X_m_C_r_e_a_t_e_C_a_s_c_a_d_e_B_u_t_t_o_n_G_a_d_g_e_t(_3_X), _X_m_C_r_e_a_t_e_P_u_l_l_d_o_w_n_M_e_n_u(_3_X),
  412.       _X_m_C_r_e_a_t_e_P_o_p_u_p_M_e_n_u(_3_X), _X_m_C_r_e_a_t_e_O_p_t_i_o_n_M_e_n_u(_3_X),
  413.       _X_m_D_i_s_p_l_a_y(_3_X), _X_m_G_a_d_g_e_t(_3_X), _X_m_L_a_b_e_l_G_a_d_g_e_t(_3_X), and
  414.       _X_m_R_o_w_C_o_l_u_m_n(_3_X).
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                        (printed 11/11/03)
  460.  
  461.  
  462.  
  463.